home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / bfind406.zip / BRUCE406.DOC < prev    next >
Text File  |  1994-06-20  |  25KB  |  524 lines
  1. BRUCE406.DOC
  2. 06/20/94
  3.  
  4. This documentation provides some overview information on a number of utilities
  5. that have been posted by Wayne Software.  All programs described herein were
  6. written by Bruce Guthrie.  Most are distributed with a Wayne Software copyright.
  7. Others were written for the U.S. Department of Commerce.  All are free for use
  8. provided relevant documentation is kept with the programs, no changes are made
  9. to the programs or documentation, and they are not bundled with commercial
  10. programs or charged for separately.
  11.  
  12. CHANGE, CONVERT, FILUPDAT, and READ are excluded from the commercial
  13. packaging restriction.  These programs are owned by the U.S.  Department of
  14. Commerce and may be re-distributed without restriction.  For these programs, I
  15. may be reached at the e-mail address BGU@CU.NIH.GOV (note--this address may
  16. change in the future).  (BGU@CU.NIH.GOV reaches me for the other programs too
  17. but I'm not to use government resources for Wayne Software things even if
  18. they're free.)
  19.  
  20. People who need to bundle AV, BFIND, COPSINCE, DATES, DIRCOMP, DIRTOTAL, FILL,
  21. FIXTEXT, FORTUNE, MULTICOL, READINIT, or READMAKE-created files in commercial
  22. packages other than shareware/freeware collections must pay a $50 registration
  23. fee to "Wayne Software" at the following address.  READMAKE-created files are
  24. also subject to this limitation.  I don't expect to make any money from these
  25. utilities but I don't want others to sell them instead.
  26.  
  27. Comments and suggestions can also be sent to:
  28.  
  29.                 Bruce Guthrie
  30.                 Wayne Software
  31.                 113 Sheffield St.
  32.                 Silver Spring, MD 20910
  33.  
  34.                 fax: (301) 588-8986
  35.  
  36. Foreign users:  Please provide an Internet e-mail address in all correspondence.
  37.  
  38.  
  39. The utilities are uploaded with a ZIP name that includes the year and month of
  40. the release.  These names are:
  41.  
  42.          AVymm.ZIP        AV program                includes CONFIGWS
  43.          BFINDymm.ZIP     BFIND program             includes CONFIGWS
  44.          CHANGymm.ZIP     CHANGE program            includes CONFIGWS
  45.          CONVRymm.ZIP     CONVERT program           includes CONFIGWS
  46.          COPSymm.ZIP      COPSINCE program          includes CONFIGWS
  47.          DATESymm.ZIP     DATES program
  48.          DIRCOymm.ZIP     DIRCOMP program
  49.          DIRTOymm.ZIP     DIRTOTAL program          includes CONFIGWS
  50.          FILLymm.ZIP      FILL program              includes CONFIGWS
  51.          FILUPymm.ZIP     FILUPDAT program
  52.          FIXTXymm.ZIP     FIXTEXT program           includes CONFIGWS
  53.          FORTNymm.ZIP     FORTUNE program           includes CONFIGWS
  54.          MULCOymm.ZIP     MULTICOL program
  55.          READymm.ZIP      READ program              includes CONFIGWS
  56.                           w/READINIT program
  57.                           w/READMAKE program
  58.  
  59.  
  60. This collection of utilities were compiled using Microsoft's Visual BASIC for
  61. DOS 1.0 compiler.  In each case, Thomas G.  Hanlin III's excellent PBClone
  62. routines, release 2.2, provided additional functionality.  Each of the utilities
  63. are separately described in a like-named *.DOC file.  This documentation
  64. (BRUCEymm.DOC--the file release date is indicated by the "ymm" parameter) serves
  65. to summarize what the various utilities consist of.
  66.  
  67. Several of the routines have defaults that can be changed by the program
  68. CONFIGWS.EXE which is included in the appropriate ZIP's.
  69.  
  70. Wayne Software also writes programs, batch files, and sets up menu systems for
  71. people on a for-fee basis.  If you desire this service, contact Wayne Software
  72. at the address specified above.
  73.  
  74.  
  75. --------------------------------------------------------------------------------
  76.  
  77. Summary of programs:
  78.  
  79. A summary of each routine follows.  See the associated *.DOC files for fuller
  80. explanations:
  81.  
  82. AV.EXE:  Archive directory viewer.  Presents list of files in archive (ZIP, ARC,
  83. etc) and lets you sort as desired.  Also allows resetting of the file date based
  84. on the archive's contents.  Syntax:
  85.  
  86.     AV filespec [ /-P | /P ] [ /Ox | /O-x ] [ /DATE ] [ /Q ] [ /? ]
  87.  
  88. BFIND.EXE:  Allows Boolean-type FIND requests.  For example, find any line with
  89. one string AND another one, or any line with one string OR another.  The syntax
  90. shown below is incomplete since "search" allows a lot of choices and allows the
  91. use of parens and Boolean operators.  Syntax:
  92.  
  93.     BFIND [ /V | /-V ] [ /C | /-C ] [ /N | /-N ] [ /I | /-I ] [ /P | /-P ]
  94.       [ /-HEADER | /HEADER ] { search } infile [ /? ] [ >filename ]
  95.  
  96. CHANGE.EXE:  Processes change commands in files.  Files can be of any size and
  97. type (e.g.  binary or text) and are processed quickly.  Up to twenty-five change
  98. commands can be processed in a single pass.  Also provides ability to remove
  99. trailing spaces from text files.  Syntax:
  100.  
  101.     CHANGE infile [ ctlfile | /Cctlfile |
  102.       /FROM string /TO string [ /IN search ] ]
  103.       [ /LINES { line1-line2 | line1 linect } ... ] [ /V | /-V ] [ /I | /-I ]
  104.       [ /Noutfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ] ]
  105.       [ /Fflagfile ] [ /Ttempfile ] [ /TRIM | /-TRIM ]
  106.       [ /BINARY | /TEXT ] [ /VERIFY | /-VERIFY ] [ /Q ] [ /? | /?&H ]
  107.  
  108. CONFIGWS.EXE:  Lets you change some of the defaults for some of the programs.
  109. Is included in the ZIP file with whatever routines it supports.  Syntax:
  110.  
  111.     CONFIGWS [ routine ] [ /MONO | /-MONO | /COLOR | /-COLOR ] [ /? ]
  112.  
  113. CONVERT.EXE:  Converts data between data formats:  FROM dBase, ASCII-delimited
  114. (commas between fields and quotes around strings), and fixed field TO Lotus WKS,
  115. ASCII-delimited, dBase, and fixed field.  Syntax:
  116.  
  117.     CONVERT infile [ outfile [ deffile ] ] [ [ /DEF=deffile ] [ /DEF | /-DEF ]
  118.       [ /OVERWRITE | /-OVERWRITE | /APPEND | /OVERASK ]
  119.       [ /FROM FIXED | /FROM ASCII | /FROM DBF ] [ /DELETED ]
  120.       [ /TO FIXED | /TO ASCII | /TO WKS | /TO DBF ] [ /HEADER | /-HEADER ]
  121.       [ /DELIMS=aroundstrings,aroundnums,betweenfields ] [ /BEEP | /-BEEP ]
  122.       [ /INMISS=val ] [ /INMISSC=val ] [ /OUTMISS=val ] [ /OUTMISSC=val ]
  123.       [ /SKIP | /MISSING | /ABORT ] [ /Q ] [ /? | /?&H ]
  124.  
  125. COPSINCE.EXE:  Copies all files modified since a given date.  Primarily used for
  126. making sure you have a back-up of stuff and also to copy updated programs to
  127. another place.  Lets you define your own groupings of files if desired.  Syntax:
  128.  
  129.     COPSINCE [ from_dir | from_dir\filespec [ to_dir ] ] [ /TO to_dir ]
  130.       [ mm/dd/yy | -n ] [ /ALL | /TEXT | /filetype ] [ /-I ]
  131.       [ /REPLACE | /-REPLACE ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ]
  132.  
  133. DATES.EXE:  Simple program that warns you in advance when an event like a
  134. birthday, anniversary, or holiday is coming up.  The idea is to give you advance
  135. warning so you can send a card or get out of town in time.  Syntax:
  136.  
  137.     DATES date_file [ days | /Ddays ] [ /-A | /A ] [ /? ]
  138.  
  139. DIRCOMP.EXE:  Similar in some ways to DOS's REPLACE command but adds ability to
  140. delete extra files in the destination subdirectory, copy hidden and system
  141. files, and prepare a report showing inconsistencies.  Syntax:
  142.  
  143.     DIRCOMP directory1 directory2 [ /S ] [ /CREATE ]
  144.       [ /UPDATE ] [ /KILL ] [ /CLONE ] [ /MOVE ] [ /ATTR=[H][S][R] ] [ /NET ]
  145.       [ /Frptfile | /-F ] [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ]
  146.       [ /ALL ] [ /Td: ] [ /Q ] [ /? ]
  147.  
  148. DIRTOTAL.EXE:  Prepares report showing files in subdirectory or drive.  Allows
  149. some restriction requests (show only files with date greater than a certain
  150. value).  Similar to Norton's FF and Ray Van Tassle's WIZ command (which is a
  151. great program but it doesn't work on network or CD-ROM discs) in some ways but
  152. presents a more formal report.  Also allows you to look for duplicate file names
  153. and search by attributes or dates.  Syntax:
  154.  
  155.     DIRTOTAL [ [ drive: ] ... [drive:][filespec] |
  156.         [ drive: ] ... [drive:]\path[\filespec] ]
  157.       [ /NORMAL | /WIDE | /THIN | /SPLIT ] [ /DUPS ] [ /CHILD ]
  158.       [ /NL ] [ /-HEADERS ] [ /-FOOTERS ] [ /CLUSTERS | /-CLUSTERS ]
  159.       [ /S { GT | GE | LT | LE | EQ | NE } value ]
  160.       [ /D { GT | GE | LT | LE | EQ | NE } mm/dd/yy ]
  161.       [ /ATTR=attr ] [ /Frptfile ] [ /Z |